home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1999 August / Macworld (1999-08).dmg / Shareware World / Utilities / Disk & File / Odd Jobs 1.3 / Odd Jobs / Odd Jobs.rsrc / STR#_1003.txt < prev    next >
Text File  |  1999-05-19  |  4KB  |  185 lines
  1. For examples of attribute patterns see the Attributes help.
  2.  
  3.  
  4.  
  5. are not special inside [...]; only "]", "-" and "\" need a "\" prefix.
  6.  
  7. Matches any name containing a meta character.  Most meta characters
  8.  
  9. *[<>[\]()|#!?*\-\\]*
  10.  
  11.  
  12.  
  13. zeros are necessary to avoid ambiguity (\90 would match "Z").
  14.  
  15. Matches any name containing a tab followed by a zero.  Note that leading
  16.  
  17. *\0090*
  18.  
  19.  
  20.  
  21. names containing invisible characters (control characters and delete).
  22.  
  23. This pattern is used by the Show Weird Names joblet to find file/folder
  24.  
  25. *[\0-\31\127]*
  26.  
  27.  
  28.  
  29. to match an empty string.
  30.  
  31. in ".ps" or ".eps" or ".epsf".  Note that nesting is allowed, and it is possible
  32.  
  33. This pattern is used by the Send PS joblet to match file names that end
  34.  
  35. *.(ps|eps(|f))
  36.  
  37.  
  38.  
  39. Matches names with at least 20 characters but no spaces.
  40.  
  41. [!  ]<20->
  42.  
  43.  
  44.  
  45. Matches names containing only letters and hyphens.
  46.  
  47. [a-z\-]<1->
  48.  
  49.  
  50.  
  51. More complicated examples:
  52.  
  53.  
  54.  
  55.            Only useful in Change Location; see that job's help item.
  56.  
  57.            later use; eg. *.(log)#1.  Up to 10 strings can be saved (#0..#9).
  58.  
  59. #d      Only special immediately after (...) to save the matching string for
  60.  
  61.  
  62.  
  63. (...)   Match a subpattern; eg. *.(abc|x?z|m*m).
  64.  
  65.  
  66.  
  67. |         Means "or".  For matching alternative patterns; eg. ab*|xy*.
  68.  
  69.  
  70.  
  71.           or inside <...> to separate minimum and maximum counts; eg. <2-5>.
  72.  
  73. -        Only special inside [...] to indicate a character range; eg. [a-z],
  74.  
  75.  
  76.  
  77.           Note that * is equivalent to ?<->.
  78.  
  79.           maximum count is missing then infinity is assumed.
  80.  
  81.           If the minimum count is missing then 0 is assumed, and if the
  82.  
  83.           This can be a fixed count like <3>, or a variable count like <3-6>.
  84.  
  85. <...>    Specifies a repeat count for the preceding pattern element.
  86.  
  87.  
  88.  
  89.            immediately after [.
  90.  
  91. !         Means "not".  Only special if it's the first character of a pattern or
  92.  
  93.  
  94.  
  95. [!...]   Matches any character NOT in the given list; eg. [!aeiou].
  96.  
  97.  
  98.  
  99. [...]    Matches any character in the given list; eg. [abc].
  100.  
  101.  
  102.  
  103.           Handy for invisible characters; eg. \9=tab \13=return \127=delete.
  104.  
  105.           The number can have up to 3 digits and any value from 0 to 255.
  106.  
  107. \ddd   Matches the character represented by the given number.
  108.  
  109.  
  110.  
  111.           in case you need to match a meta character; eg. \* \? \[ \< \\.
  112.  
  113. \c      Matches the character c (any non-digit).  The \ prefix is useful
  114.  
  115.  
  116.  
  117. ?       Matches any single character.
  118.  
  119.  
  120.  
  121. *       Matches zero or more characters.
  122.  
  123.  
  124.  
  125. The above examples illustrate most of the special meta characters:
  126.  
  127.  
  128.  
  129. *\13            - match names ending with a return
  130.  
  131. *\9*            - match names containing a tab
  132.  
  133. *\0*            - match names containing a null
  134.  
  135. *\\*             - match names containing "\"
  136.  
  137. *\**            - match names containing "*"
  138.  
  139. [!a-z]<1->   - match names containing no letters
  140.  
  141. [a-z]<1->    - match names containing only letters
  142.  
  143. *[0-9]        - match names ending with a digit
  144.  
  145. [a-z]*         - match names starting with a letter
  146.  
  147. *[xyz]*       - match names containing any character in the given list
  148.  
  149. ?<-10>        - match names with at most 10 characters
  150.  
  151. ?<10->        - match names with at least 10 characters
  152.  
  153. ?<10-20>   - match names with 10 to 20 characters
  154.  
  155. ?<10>          - match names with exactly 10 characters
  156.  
  157. ?                  - match names with just one character
  158.  
  159. *.???          - match names ending with a dot plus 3 more characters
  160.  
  161. *(aa|bb)*   - match names containing "aa" or "bb"
  162.  
  163. a*|*z           - match names starting with "a" or ending with "z"
  164.  
  165. *xyz            - match names ending with "xyz"
  166.  
  167. !abc*           - match names not starting with "abc"
  168.  
  169. abc*            - match names starting with "abc"
  170.  
  171. *abc*          - match names containing the string "abc"
  172.  
  173. *a*              - match names containing the letter "a"
  174.  
  175. *                  - match every name (or type/creator/attribute)
  176.  
  177.  
  178.  
  179. match given patterns.  Here are some simple examples:
  180.  
  181. to restrict processing to files whose names/types/creators/attributes
  182.  
  183. Odd Jobs has powerful pattern matching capabilities.  Most jobs allow you
  184.  
  185.